home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / coral / README < prev    next >
Text File  |  1995-05-03  |  2KB  |  63 lines
  1.  
  2.  
  3. Written by Ronald Joe Record (rr@sco.com) 05 Apr 1993
  4.  
  5. INTRO
  6. -----
  7.  
  8. The idea here is to calculate and display aggregating particles.
  9. In order to accomplish this, a modified random walk algorithm is used.
  10. Initial particles are "seeded" at the "bottom" or the "sea". Particles
  11. are then "dropped" randomly from above. When a particle comes within a
  12. pixel of an already existent particle, it "sticks". After N particles 
  13. have "stuck", the color is incremented. Thus, color indicates "age".
  14.  
  15. ACKNOWLEDGEMENTS
  16. ----------------
  17.  
  18. The algorithm was derived from lectures given by Dietmar Saupe at the 
  19. University of California at Santa Cruz. Assistance with colormaps and 
  20. spinning color wheels and X was gleaned from Hiram Clawson and Stacey Campbell.
  21.  
  22. BUILD
  23. -----
  24.  
  25. To build the coral binary, either use the Imakefile or the sample makefile,
  26. Makefile.std. If your system doesn't support prototypes, uncomment the 
  27. PROTODEFINE line of the Imakefile.
  28.  
  29. After modifying the Imakefile appropriately, either use "xmkmf" or "imake"
  30. to create a Makefile. Then just type "make" to compile coral.
  31.  
  32. The manual page can be formatted by typing "nroff -man coral.man > coral.6X".
  33.  
  34. INSTALL
  35. -------
  36.  
  37. To install coral, copy the coral binary to the desired location (the sample
  38. makefile puts it in /usr/games/X11)
  39. Copy the formatted man page to wherever you keep your local doc (i use
  40. /usr/games/X11/doc for games and imaging software), then add that location
  41. to your MANPATH.
  42.  
  43. TEST
  44. ----
  45.  
  46. You can test coral by just invoking it with no arguments. It should display
  47. a 512x480 image. Some workstations may be slow to calculate and display the
  48. coral growth as there are many calculations involved.
  49.  
  50. Some "interesting" ways to run coral are as follows :
  51. % coral -F -n 10 -d
  52. (use the full screen, calculate 10 maps in demo mode)
  53. % coral -R
  54. (display on the root window)
  55. % coral -o coralgrowth.ppm
  56. (calculate and display with default parameters and save the resulting image
  57.  as a PPM file called coralgrowth.ppm. this can be viewed later using xv or 
  58.  any PPM viewing utility)
  59.  
  60. Ideas, comments, additions, deletions, suggestions, bug reports, code review,...
  61. e-mail Ronald Record at rr@sco.com or ...uunet!sco!rr.
  62.  
  63.